<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>Chapter 9. 設定ファイル</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.75.1">
<link rel="home" href="index.html" title="Smarty マニュアル">
<link rel="up" href="smarty.for.designers.html" title="Part II. テンプレートデザイナのための Smarty">
<link rel="prev" href="language.function.textformat.html" title="{textformat}">
<link rel="next" href="chapter.debugging.console.html" title="Chapter 10. デバッギングコンソール">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<div class="navheader">
<table width="100%" summary="Navigation header">
<tr><th colspan="3" align="center">Chapter 9. 設定ファイル</th></tr>
<tr>
<td width="20%" align="left">
<a accesskey="p" href="language.function.textformat.html">Prev</a> </td>
<th width="60%" align="center">Part II. テンプレートデザイナのための Smarty</th>
<td width="20%" align="right"> <a accesskey="n" href="chapter.debugging.console.html">Next</a>
</td>
</tr>
</table>
<hr>
</div>
<div class="chapter" title="Chapter 9. 設定ファイル">
<div class="titlepage"><div><div><h2 class="title">
<a name="config.files"></a>Chapter 9. 設定ファイル</h2></div></div></div>
<p>
  設定ファイルは、１つのファイルからグローバルなテンプレート変数を管理する方法として、
  デザイナーにとって有用です。１つの例としては、テンプレートの色の指定を行う場合です。
  通常、アプリケーションの配色を変更するには全てのテンプレートファイルを調べ、
  該当する箇所の色の指定を変更する必要があります。
  設定ファイルを使うと色の指定を一箇所で管理できるので、
  更新する必要があるファイルは１つだけになります。
 </p>
<div class="example">
<a name="id2815543"></a><p class="title"><b>Example 9.1. 設定ファイルの記述例</b></p>
<div class="example-contents"><pre class="programlisting">

# グローバル変数
pageTitle = "Main Menu"
bodyBgColor = #000000
tableBgColor = #000000
rowBgColor = #00ff00

[Customer]
pageTitle = "Customer Info"

[Login]
pageTitle = "Login"
focus = "username"
Intro = """This is a value that spans more
           than one line. you must enclose
           it in triple quotes."""

# 隠されたセクション
[.Database]
host=my.example.com
db=ADDRESSBOOK
user=php-user
pass=foobar

  </pre></div>
</div>
<br class="example-break"><p>
  <a class="link" href="language.config.variables.html" title="設定ファイルから読み込まれた変数">設定ファイルの値</a>
  はクォートで囲む事が出来ます(必須ではありません)。
  シングルクォートとダブルクォートのどちらでも使用できます。
  複数行にまたがる値を持つ場合は、値全体をトリプルクォート(""")
  で囲みます。設定ファイルの中にコメントを記述するには、
  行の初めに <code class="literal">#</code> (ハッシュ) を使う事を推奨します。
 </p>
<p>
  上記の設定ファイルの例は２つのセクションを持っています。
  セクション名はブラケット[]に囲まれ、<code class="literal">[</code>
  もしくは <code class="literal">]</code> を含まない任意の文字列を指定できます。
  先頭の４つの変数は、グローバル変数 (あるいはセクションに含まれない変数)
  です。これらの変数は常に設定ファイルから読み込まれます。
  特定のセクションが読み込まれた場合は、
  グローバル変数に加えてそのセクションからの変数が読み込まれます。
  グローバル変数とセクション内に同じ変数が存在する場合はセクション内の変数が使用されます。
  １つのセクション内に同名の２つの変数を指定した場合は、
  <a class="link" href="variable.config.overwrite.html" title="$config_overwrite">
  <em class="parameter"><code>$config_overwrite</code></em></a>
  が無効でない限りは後で指定されたものが使用されます。
 </p>
<p>
  設定ファイルの読み込みは、組み込みのテンプレート関数
  <a class="link" href="language.function.config.load.html" title="{config_load}"><code class="varname">
  {config_load}</code></a> あるいは API 関数 <a class="link" href="api.config.load.html" title="config_load()"><code class="varname">config_load()</code></a>
  によって行います。
 </p>
<p>
  <code class="literal">[.hidden]</code> のように変数名又はセクション名の先頭にピリオドをつける事によって、
  変数又は全体のセクションを隠蔽する事ができます。
  アプリケーションからは使用されるがテンプレートエンジンからは使用されないような重要なデータ
  (DB接続に関する情報など) を取得する際に有用です。
  テンプレートを編集をするサードパーティが存在する場合、
  重要なデータを含んだ設定ファイルをテンプレート内に読み込む事によって盗み読まれる危険性を回避できます。
 </p>
<p>
  <a class="link" href="language.function.config.load.html" title="{config_load}"><code class="varname">{config_load}</code></a>、
  <a class="link" href="variable.config.overwrite.html" title="$config_overwrite"><em class="parameter"><code>$config_overwrite</code></em></a>、
  <a class="link" href="api.get.config.vars.html" title="get_config_vars()"><code class="varname">get_config_vars()</code></a>、
  <a class="link" href="api.clear.config.html" title="clear_config()"><code class="varname">clear_config()</code></a>
  および
  <a class="link" href="api.config.load.html" title="config_load()"><code class="varname">config_load()</code></a>
  も参照してください。
 </p>
</div>
<div class="navfooter">
<hr>
<table width="100%" summary="Navigation footer">
<tr>
<td width="40%" align="left">
<a accesskey="p" href="language.function.textformat.html">Prev</a> </td>
<td width="20%" align="center"><a accesskey="u" href="smarty.for.designers.html">Up</a></td>
<td width="40%" align="right"> <a accesskey="n" href="chapter.debugging.console.html">Next</a>
</td>
</tr>
<tr>
<td width="40%" align="left" valign="top">{textformat} </td>
<td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td>
<td width="40%" align="right" valign="top"> Chapter 10. デバッギングコンソール</td>
</tr>
</table>
</div>
</body>
</html>
